Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Despooling Messages

GXExamineSpoolFile

QuickDraw GX sends the GXExamineSpoolFile message just prior to establishing communications with a device. You need to override the GXExamineSpoolFile message if you have your own spool file format. Your override code of the GXExamineSpoolFile message must match the following formal declaration:

OSErr MyExamineSpoolFile (gxSpoolFile aSpoolFile);

aSpoolFile

The spool file.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the GXExamineSpoolFile message just prior to opening the connection to the device.

If you are using the default spool-file format, you rarely need to override the GXExamineSpoolFile message.

The default implementation of this message checks the spool file for consistency before allowing it to be printed.

SPECIAL CONSIDERATIONS

You never send the GXExamineSpoolFile message yourself. You rarely need to override this message.

If you are using your own spool file format, you need to totally override the GXExamineSpoolFile message. Otherwise, you need to forward it to other handlers, either before or after performing your own tasks.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help